home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / internet / javaedit.zip / README.TXT < prev   
Text File  |  1996-05-19  |  10KB  |  234 lines
  1. ********************************************************************************
  2. * Dick Chase's Java Editor Readme                                              *
  3. * Version: 2.01 - May 19, 1996                                                 * 
  4. * Copyright: Copyright ⌐ 1996, Richard L. Chase - All Rights Reserved.         *
  5. * Java(tm) is a trademark of Sun Microsystems.                                 *
  6. * Delphi(tm) is a trademark of Borland International.                          *
  7. * Netscape(tm) is a trademark of Netscape Communications Corporation.          *
  8. * Other trademarks are the trademarks of those owning the trademark, except    *
  9. *   for those rare cases where the trademark is owned by those who don't       *
  10. *   own the trademark, in which case the trademark is owned by someone else    *
  11. *   entirely, unless they happen to be the same, in which case the trademark   *
  12. *   is owned by both of them.                                                  *
  13. ********************************************************************************
  14.  
  15. NOTE: this is a 32 bit application and will work *only* with Windows 95
  16.       and Windows NT
  17.  
  18. General Description:
  19. ====================
  20. A simple MDI text editor for editing Java source code.
  21. Compile your java source and load html files from within the editor.
  22.  
  23.   Editing Files:
  24.   Works just like notepad, except you can have several files open at once.
  25.  
  26.   Compiling Java:
  27.   Clicking on the 'Compile Java' button compiles the source in the active
  28.   window. A panel in text window opens to display the compiler results.
  29.   Double-Clicking on an error line highlights the corresponding line in your
  30.   code.
  31.  
  32.   Running HTML:
  33.   Clicking on the 'Load Web Browser' button loads the contents of the
  34.   open window into your web browser.
  35.  
  36. Changes from v2.0:
  37. ==================
  38. Bug fixes:
  39. ----------
  40.   Bug:      Dropping a file from windows on the project manager adds the file 
  41.             to the project, but dropping files on Javaedit's executable or icon,
  42.             or dropping a file in javaedit's main window does not open the 
  43.             dropped file(s).
  44.   Analysis: The code was there, but I put it in the wrong place.
  45.   Fix:      I put the code in the right place and performed the novel task of 
  46.             actually testing it <G>.
  47.  
  48.  
  49. Enhancements:
  50. -------------
  51.   None.
  52.  
  53. Modifications:
  54. --------------
  55.   None.
  56.  
  57. Known Problems:
  58. ---------------
  59.   It doesn't work well with NT 3.5X because of the use of the new windows 
  60.   RichTextEdit control. It should work fine with NT 4.0 which has the new control. 
  61.   I'm going to try to fix this by using the generic edit control, but I use the 
  62.   native Search and replace of methods RichTextEdit, so it may take me a little 
  63.   while to duplicate the functionality with my own code.
  64.  
  65. Changes from v1.0:
  66. ==================
  67. Bug fixes:
  68. ----------
  69.   Bug:      Not all or no compiler errors were being reported.
  70.   Analysis: The output from the compiler was being directed into an in-memory
  71.             stream. For some reason, especially on fast machines, only the
  72.             first few lines, if any, were received.
  73.   Fix:      Directing the output to a file stream solves this problem. I have
  74.             no idea if it was a Delphi or a Windows problem.
  75.  
  76.   Bug:      Browser would not launch from editor.
  77.   Analysis: Something is incorrect or missing in the CURRENT_USER section
  78.             of the Win95 registry.
  79.   Fix:      You can now also enter the location of your browser manually in the
  80.             application settings dialog (File|Configure Editor, External
  81.             Applications Tab). NOTE: You can also use the Java appletviewer
  82.             instead of a browser by entering the complete path to
  83.             appletviewer.exe.
  84.  
  85. Enhancements:
  86. -------------
  87.   Projects:
  88.   Files can now be grouped into projects. An explorer-like project manager
  89.   provides iconic or list views of project files and compiler settings for
  90.   the project. You can add files with drag and drop, and compile Java files
  91.   or load html files in you browser directly from the project manager.
  92.  
  93.   Compile without saving:
  94.   you can compile Java source code or load html text in a browser without
  95.   saving it first.
  96.  
  97.   Jump to errors:
  98.   Double-Clicking on a compiler error highlights the correspondin line in your
  99.   code.
  100.  
  101.   Run Java:
  102.   you can now run java applications directly from the editor.
  103.   "Run|Run Java" opens a dialog where you can enter a command line to pass to
  104.   the Java interpreter.
  105.  
  106.   Running the Java appletviewer:
  107.   Ok, this really isn't an enhancement, but is made possible because of a
  108.   bug fix. Because you can now manually set your browser, entering the
  109.   path to appletviewer.exe in the browser setting will load an html file
  110.   in the Java appletviewer.
  111.  
  112.   Tab Settings:
  113.   Pressing the tab key now insert spaces instead of the ascii tab character.
  114.   The number of settings is configurable (File|Configure Editor). The default
  115.   is 4 spaces.
  116.  
  117. Modifications:
  118. --------------
  119.   Because of the new project orientation, Applications settings have been
  120.   split between tha application and projects.
  121.  
  122.   Project Settings (Compiler options & Project Files):
  123.     Select View|Project Manager
  124.   Application Settings (Font, program locations):
  125.     Select File|Configure Editor
  126.  
  127. Known Problems:
  128. ---------------
  129.   By default, if Netscape is your browser, the editor uses DDE to load html
  130.   files in the browser. This way, only one instance of Netscape is loaded
  131.   in relation to the editor so that each time you "Load in Browser",
  132.   Netscape simply replaces the document in that window. There appears to be
  133.   a bug in either my code, Delphi's DDE control or Netscape, however:
  134.     if you "Load in Browser" when Netscape is not already started, Netscape
  135.     starts, but the document fails to load. With the next "Load in Browser",
  136.     a new Netscape window is created and the document loads in that window.
  137.     Subsequent "Load in Browser" actions replace the document in that window.
  138.  
  139.   Work-arounds to this problem are:
  140.   1) Start Netscape before any "Load in Browser" actions.
  141.   2) When loading an html document in Netscape during a JavaEdit session when
  142.      Netscape is not already open, do it twice and then close the first
  143.      Netscape window.
  144.   3) An option in the application settings is "Use DDE with Netscape".
  145.      Uncheck this and "Load in Browser" will load your document by command line
  146.      parameter instead of DDE. Of course, this means that each
  147.      "Load in Browser" action will result in a new Netscape window. I can see
  148.      why this could actually be considered a good thing, so we'll just
  149.      call this a feature rather than a work-around <G>.
  150.  
  151. Guarantee/Warranty:
  152. ===================
  153. There are no guarantees or warranties in life, and there are none for this
  154. application either. BY USING DICK CHASE'S JAVA EDITOR YOU AGREE THAT YOU
  155. ARE DOING SO ENTIRELY AT YOUR OWN RISK.
  156.  
  157. License:
  158. ========
  159. This is being distributed as freeware. This means you don't owe the author
  160. anything for rights to use this application. This doesn't mean you own the
  161. application, though. The author retains all rights to the application, you
  162. just have the right to use it. You also have the right to freely distribute
  163. this application, as long as you do not charge anything for it and this
  164. Readme.txt file is included.
  165.  
  166. If you do like the application, the author would appreciate it if you let
  167. him know with a simple e-mail message. Heck, he'd even like to know if
  168. you don't like the application. Of course, if you really want to send the
  169. author money (or donate to a charity or send a postcard from an exotic
  170. locale), the author will most likely accept it :)
  171.  
  172.  
  173. Installation:
  174. -------------
  175. Copy javaedit.exe to some directory and run it.
  176.  
  177. To compile Java sources, you need to tell the application where the
  178. Java compiler is on your machine:
  179.   Select File|Configure Editor.
  180.   Select the 'Java Compiler' page.
  181.   Enter the path to the Java compiler (javac.exe).
  182.  
  183. To load html files into your browser, the application needs to know the
  184. location of your browser. If you have Netscape 2.0 installed, the application
  185. should find it automatically via info in your Win95 registry. If it doesn't,
  186. you can manually enter the path to your browser:
  187.   Select Edit|Settings.
  188.   Select the 'Java Compiler' page.
  189.   Enter the path to the Java compiler (javac.exe).
  190.  
  191. Future Plans:
  192. -------------
  193. Word's too cumbersome for editing simple text and it's a royal pain to
  194. edit several sources with word pad. Then you have to open a Dos Window to
  195. compile. So this editor solves a current need for me. I hope you find it
  196. useful too.
  197.  
  198. Unless there's a strong demand, I'm probably not going to develop any new
  199. versions of JavaEdit. Work is getting busy and complete visual IDEs are
  200. due out very shortly.
  201.  
  202. ***I WILL fix any bugs that are reported*** (or at least try <G>). So far I
  203. have only tested this version myself, so I'm sure there may be some things
  204. that won't work on some people's machine's/configurations.
  205.  
  206. I will also consider recommendations for enhancements, but I make no promises
  207. (note: syntax highlighting has been a common request. I started working on it,
  208. but to do it well will take much more time than is available to me (the code's
  209. easy, but mapping out java syntax for parsing, especially in such an extensible
  210. language, is simply beyond the scope of a spare-time project).
  211.  
  212. JavaEdit was built with Delphi 2.0. If you want to enhance it, at the risk of
  213. great embarassment, I am willing to provide the source code. There are a few
  214. caveats to this offer, however:
  215. 1) I retain all rights to and ownership of any code provided by me.
  216. 2) The code comes with no warranties of any kind.
  217. 3) Any software created with any or all of the JavaEdit source code provided
  218.    by me may NOT be sold for any renumeration of any kind without my express
  219.    written permission. (Hey, I don't want any money for my application, but
  220.    if you make money with help from my work, I'd like a cut).
  221. 4) I'm notified and provided the opportunity to get a free copy of whatever
  222.    software is created with the code.
  223.  
  224. Contacting Me (Dick Chase):
  225.  
  226. e-mail: 
  227.  Internet - dchase@tiac.net (Read almost daily)
  228.  CIS - 72420,2703 (Read at least weekly)
  229.  
  230. Regular Mail:
  231.   24 Rennie Drive
  232.   Blackstone, MA 01504
  233.  
  234. **END README**